home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / bibtex / utils / bibindex / README < prev   
Text File  |  1993-05-31  |  2KB  |  48 lines
  1. /u/sy/beebe/tex/bibindex/2-4/README, Tue Jun  1 17:00:51 1993
  2. Edit by Nelson H. F. Beebe <beebe@plot79.math.utah.edu>
  3.  
  4. This directory contains bibindex and biblook, programs for fast lookup
  5. in BibTeX bibliography data bases.  They were written by Jeff
  6. Erickson, now at the University of California, Berkeley.
  7.  
  8. bibindex converts a .bib file to a .bix file, which is a compact
  9. binary representation of the .bib file containing hash tables for fast
  10. lookup, as well as byte offset positions into the corresponding .bib
  11. file.
  12.  
  13. biblook provides an interactive lookup facility using the .bix and
  14. .bib files.  It verifies that the file version number and bibindex
  15. version number match its own values, and also compares the file time
  16. stamps so that it can detect whether the .bix file is out-of-date with
  17. respect to the .bib file.  In either case, execution terminates.
  18.  
  19. biblook may provide a more convenient, and faster, way of searching
  20. .bib files than text editors or pattern search utilities like the grep
  21. programs, particularly since it supports boolean operations between
  22. pairs of patterns.
  23.  
  24. Both programs are documented in UNIX man pages, and the *.txt files
  25. are the output of nroff+col processing of the *.man files, so that
  26. documentation can read even if nroff is unavailable (e.g. non-UNIX
  27. systems, or UNIX systems where it is an extra-cost option).
  28.  
  29. The programs so far run only under UNIX.  Plans are to investigate the
  30. possibility of making them work on other operating systems.
  31.  
  32. For very large bibliography files, it may be necessary to change the
  33. type Index_t in biblook.h from "unsigned short" to "unsigned int".
  34. The choice in version 2.4 and earlier of "unsigned short" is suitable
  35. for the SIGGRAPH and TeX User Group bibliography collections
  36. (SIGGRAPH: 6.7MB with 15,400 entries; TUG: 3.9MB with 14,600 entries).
  37. as of June 1993.  Using "unsigned int" increases the size of the .bix
  38. files by 55% (TUG) to 68% (SIGGRAPH).
  39.  
  40. Author of README and *.man files:
  41.     Nelson H. F. Beebe
  42.     Center for Scientific Computing
  43.     Department of Mathematics
  44.     University of Utah
  45.     Salt Lake City, UT 84112
  46.     USA
  47.     Email: beebe@math.utah.edu (Internet)
  48.